home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / dev / debug / PoolWatch1_01.readme < prev    next >
Encoding:
Text File  |  1995-04-27  |  3.5 KB  |  78 lines
  1. Short:    Debug tool for pool-allocations, a la Mungwall (OS3.x)
  2. Author:   Magne Oestlyngen (magneo@stud.cs.uit.no)
  3. Uploader: Magne Oestlyngen (magneoe@stud.cs.uit.no)
  4. Type:     dev/debug
  5.  
  6. ------------------==================================------------------
  7. 950406
  8.                         PoolWatch release 1.01
  9.  
  10.             Requires AmigaDOS 3.0 (V39) or higher to run.
  11.  
  12.              Copyright © 1994-1995 Ultima Thule Software
  13.                          All Rights Reserved.
  14.  
  15.                        Author: Magne Østlyngen
  16.  
  17. ------------------==================================------------------
  18.  
  19. Disclaimer
  20. ~~~~~~~~~~
  21. This  software  entitled  "PoolWatch"  is not public domain but freely
  22. distributable (FreeWare).  This means that you can copy it and give it
  23. to all your friends, upload it to a BBS or include it in a PD-library.
  24. The  only  restrictions  are:   All the files included in this archive
  25. must  be  in  their  original  form  without  additions,  deletions or
  26. modifications  of  any  kind.   PoolWatch  may  not be distributed for
  27. profit,  and  only  a  nominal  charge  may  be  associated  with  its
  28. distribution.   Permission  is hereby given to distribute PoolWatch on
  29. the  Fish  disks  (CD  or  floppy)  and the AmiNet CD.  If you want to
  30. distribute  "PoolWatch"  with  any  commercial  product, you will need
  31. written  permission  from the author.  "PoolWatch" is provided "AS IS"
  32. without  warranty  of  any kind, and the author is not responsible for
  33. any damage this software may do.  (Just in case :-)
  34.  
  35.  
  36. What is PoolWatch ?
  37. ~~~~~~~~~~~~~~~~~~~
  38. PoolWatch  is a debug tool for OS 3.0 and higher designed to watch and
  39. correct  illegal  allocation  and  freeing  of  memory  that  use  the
  40. pool-functions provided in OS 3.0 and upwards.  PoolWatch is necessary
  41. since  Mungwall  do  not  catch any illegal memory handling concerning
  42. pool-allocations.
  43.  
  44. PoolWatch  is especially useful in combination with Enforcer, Mungwall
  45. (which  will  watch  normal  allocations  that  use AllocMem/FreeMem),
  46. SegTracker and FindHit (included in the Enforcer archive).
  47.  
  48. If  SegTracker  is  running  in  the system when PoolWatch is started,
  49. PoolWatch   will  use  the  public  SegTracker  seglist  tracking  for
  50. identifying  the  hunk  and  offset  into the executable doing illegal
  51. allocations.
  52.  
  53.  
  54. What does PoolWatch do ?
  55. ~~~~~~~~~~~~~~~~~~~~~~~~
  56. PoolWatch  will  patch  CreatePool(), DeletePool(), AllocPooled(), and
  57. FreePooled()  in exec.library.  PoolWatch will use these functions but
  58. will add extra security on top of all pool-allocations.  In most cases
  59. of  illegal allocation/freeing, PoolWatch will report the error to the
  60. user  and  correct  the  problem  (if  possible).   Please  note  that
  61. PoolWatch  does  not offer any memory protection if a task writes to a
  62. random  addresse  in  memory,  but  will  take  care  of most problems
  63. associated with pool allocations.
  64.  
  65.  
  66. ============================= Archive contents =============================
  67.  
  68. Original  Packed Ratio    Date     Time    Name
  69. -------- ------- ----- --------- --------  -------------
  70.     6376    3485 45.3% 06-Apr-95 00:48:16  PoolWatch1_01/poolwatch
  71.     8379    3236 61.3% 06-Apr-95 00:55:40  PoolWatch1_01/PoolWatch.doc
  72.     2871    1285 55.2% 06-Apr-95 00:51:54  PoolWatch1_01/poolwatch.readme
  73.      130      98 24.6% 05-Apr-95 19:15:58  PoolWatch1_01/SCOPTIONS
  74.     1304     685 47.4% 05-Apr-95 18:13:54  PoolWatch1_01/test
  75.      975     403 58.6% 05-Apr-95 19:16:30  PoolWatch1_01/test.c
  76. -------- ------- ----- --------- --------
  77.    20035    9192 54.1% 06-Apr-95 14:22:22   6 files
  78.